GET Hero Performance Trends
/openmlbb/mlbb/heroes/{hero_identifier}/trends
API Path: /api/heroes/{hero_identifier}/trends
Get rate trends for a specific hero by ID or name over a specified time window. Supports query parameters for rank tier, past days window, pagination, and localization.
Path parameters:
- hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like
30,Yi Sun-shin, oryisunshin.
Query parameters:
- rank: Rank filter. Allowed values:
all,epic,legend,mythic,honor,glory. - past-days: Rate window in days. Allowed values:
7,15,30. - size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- lang: Language code for localized content (default:
en).
The response includes hero rate trend data:
- records: Array of hero entries, each containing:
- _id: Unique record identifier.
- _createdAt: Creation timestamp.
- _updatedAt: Last update timestamp.
- data:
- main_heroid: Hero ID.
- bigrank: Rank tier identifier.
- camp_type: Camp type indicator.
- match_type: Match type indicator.
- win_rate: Array of daily statistics, each containing:
- date: Date of record.
- app_rate: Appearance rate (pick frequency).
- ban_rate: Ban rate.
- win_rate: Win rate.
This endpoint is useful for:
- Tracking hero performance trends over time.
- Monitoring hero popularity and ban frequency.
- Comparing win rates across different ranks and time periods.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.mlbb.hero_trends("miya", rank="all", size=20, index=1, lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| hero_identifier | path | string | yes | - |
| rank | query | string | no | all |
| past-days | query | string | no | 7 |
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| lang | query | string | no | en |